2026-02-25

在 Telegram 搭建多智能体 OpenClaw团队保姆级教程

转载
https://x.com/jingwangtalk/status/2025560574483173809?s=20

1. 在 Telegram 配置主 Agent 机器人

telegram中搜索BotFather
/newbot
先取名字
再写username,要以_bot为结尾

image.png

2. 命令行添加telegram机器人

openclaw configure

选择 Local → Channels → Telegram,粘贴 token。完成。

回到 Telegram,打开机器人聊天窗口,发送 /start,你会收到一个配对码。在服务器上执行:
image.png

openclaw pairing approve telegram G3SL3YNN

3. 通过 Telegram 群组创建sub-Agent

每个子 Agent 对应一个独立的 Telegram 群组。主 Agent 加入群组后,以"影分身"的形式存在——同一个 Gateway,独立工作区,独立人设。

先配置 BotFather 权限:

进入 BotFather → /mybots → 选择你的主 Agent,在配置中:

  • Allow Groups? → 开启(Enabled)

  • Group Privacy → 关闭(Disabled)

创建群组:

  1. 新建一个 Telegram 群组,把主 Agent 机器人拉进来。再拉@getidsbot机器人
  2. @getidsbot机器人会返回群组id
  3. 复制返回的群组 ID。

4. 将群组绑定到新 Agent

跟大家分享一下一个很重要的Prompt模版,不管是你配置了什么openclaw的模型,你几乎都可以成功完成多智能体的搭建。因为有些模型比较聪明一下就可以配好,有些模型会比较笨,需要给出比较明确的指令。

配置 OpenClaw 多 Agent 路由的完整 Prompt 模版

将以下 Prompt 发送给主 Agent 的私聊对话框(不是群组)。替换方括号内的内容:

将 Telegram 群组(ID: 【GROUP_ID】)绑定到独立 agent,请严格按以下要求执行并返回结果:

1. 创建 agent(独立 workspace)
   • name: 【AGENT_NAME】
   • model: 【LLM_MODEL】
   • 在该 workspace 写入角色设定文件(SOUL.md),以及新的 Agents.md

2. 配置路由 bindings
   • 为同一群组添加两条 peer 路由(兼容 Telegram 群类型):
     - peer: { kind: "group", id: "【GROUP_ID】" }
     - peer: { kind: "channel", id: "【GROUP_ID】" }
   • accountId 设置为 main_bot
   • 两条都指向这个 agent
   • 不要删除已有其他 agent 的有效 bindings

3. 配置 Telegram 群策略
   • channels.telegram.groups["*"].requireMention = true(如已存在则忽略)
   • channels.telegram.groups["【GROUP_ID】"].requireMention = false
   • channels.telegram.groups["【GROUP_ID】"].groupPolicy = "open"

4. 防止主 agent 抢群消息
   • main 的 telegram 绑定仅保留私聊:
     - peer: { kind: "direct", id: "【YOUR_TELEGRAM_ID】" }(如已存在则忽略)
   • 确保 main 不会接管目标群组消息